home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm1 / lotery46.zip / LOTTERY.DOC < prev    next >
Text File  |  1993-03-22  |  15KB  |  285 lines
  1.  
  2.         One of the Livewire Collection of multi-BBS Doorware programs.
  3.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  4.           UltraBBS, Telegard, TriTel, TriBBS, Remote Access, and WWIV
  5.  
  6.                                 Richard Paquette
  7.                                    PO Box 416
  8.                               Mt. Laurel, NJ 08054
  9.  
  10.                            (c) Copyright 1989 - 1993
  11.                               All Rights Reserved
  12.  
  13. The door creates a file called "intoday.dat", this file is to monitor
  14. how many times that caller entered the door today! You set in the config file
  15. how many times they are allowed in.
  16.  
  17. If you delete this file, no record is kept and the caller will again be
  18. able to enter to door freely. PLEASE do not delete this file.
  19.  
  20. IMPORTANT NOTE: There is now a feature where you can let a winner of 
  21. the Pick-3 or Pick-4 download a "Coupon" to redemm at your place of business.
  22. For example, you own a Pizza Parlor and want to give the winner a free pizza
  23. for the Pick-3 or Pick-4, then create with any ascii editor two files called,
  24. "coupon3.dat" and "coupon4.dat", YOU MUST LEAVE THE FIRST LINE AS IS in the
  25. example, we will write starting on Line 1, Column 17 the Ticket Number that is
  26. assigned to THAT WINNER! The rest of the file can be anything you want such as
  27. a discount coupon to be mailed in for access minus the value of the coupon or
  28. anything that you are willing to offer. NOTE: if you don't want to use this
  29. added feature, then rename or DELETE the coupon*.dat files. If they aren't
  30. there, the program will act as usual, if they are there, after winning, the
  31. door will take the winner to a download screen where they can download the
  32. coupon to be printed and redemmed at your place of business.
  33.  
  34. The Ticket number is also written to the winner3.dat and winner4.dat
  35. files for you to compare when someone brings in a winning coupon!
  36.  
  37. You can now charge time for each Pick-3 or Pick-4 attempt, if you put
  38. a 0 on the last line of the cfg, they will not be charged any time, if you
  39. decide to charge time to play the game and they win, the time is given back
  40. to them along with your prizes.
  41.  
  42.                                CONFIGURATION FILE
  43.  
  44. C:\PCB\USERS.SYS                    <- Path/filename to System File
  45. The Livewire BBS                    <- Name of BBS
  46. Richard                             <- Sysop's first name
  47. Paquette                            <- Sysop's last Name
  48. 5                                   <- Times allowed in Door
  49. 999999                              <- Registration number (or some number)
  50. Six Month Patron Membership         <- Prize for the Pick-3 game (58 char max)
  51. Three Month Patron Membership       <- Small prize to match 2 numbers (53 max)
  52. One Year Patron Membership          <- Prize for the Pick-4 game (58 char max)
  53. Three Month Patron Membership       <- Small prize to match 2 numbers (53 max)
  54. 3                                   <- Time charged for each try in minutes
  55.  
  56. Please note that something must be on each line.. if you do not want to offer
  57. prizes for matching two numbers, simply put "No prize" without the quotes.
  58.  
  59. NOTE: If you are using the GTUSER.BBS system file, then line five and six
  60.       MUST be as the sample below shows.. then pick up the rest of the
  61.       Door variables from above to line seven etc...
  62.  
  63.                   Example configuration file for PCBOARD.SYS
  64.                   ------------------------------------------
  65.                                                                              
  66. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  67. The Livewire BBS    <=-  (Change this to your BBS name)
  68. Richard             <=-  (The Sysop's first name)
  69. Paquette            <=-  (The Sysop's last name)
  70.  
  71. Example configuration file for USERS.SYS
  72. ------------------------------------------
  73.                                                                              
  74. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  75. The Livewire BBS    <=-  (Change this to your BBS name)
  76. Richard             <=-  (The Sysop's first name)
  77. Paquette            <=-  (The Sysop's last name)
  78.  
  79. Example configuration file for DOOR.SYS
  80. ---------------------------------------
  81.                                                                              
  82. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  83. The Livewire BBS    <=-  (Change this to your BBS name)
  84. Richard             <=-  (The Sysop's first name)
  85. Paquette            <=-  (The Sysop's last name)
  86.  
  87. Example configuration file for USERINFO.DAT
  88. -------------------------------------------
  89.                                                                              
  90. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  91. The Livewire BBS    <=-  (Change this to your BBS name)
  92. Richard             <=-  (The Sysop's first name)
  93. Paquette            <=-  (The Sysop's last name)
  94. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  95.  
  96. Example configuration file for CALLINFO.BBS
  97. -------------------------------------------
  98.                                                                              
  99. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  100. The Livewire BBS    <=-  (Change this to your BBS name)
  101. Richard             <=-  (The Sysop's first name)
  102. Paquette            <=-  (The Sysop's last name)
  103.  
  104. Example configuration file for DORINFOx.DEF
  105. -------------------------------------------
  106.                                                                              
  107. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  108.                           where 'x' is the BBS Node number.
  109. The Livewire BBS    <=-  (Change this to your BBS name)
  110. Richard             <=-  (The Sysop's first name)
  111. Paquette            <=-  (The Sysop's last name)
  112.  
  113. Example configuration file for SFDOORS.DAT
  114. ------------------------------------------
  115.                                                                              
  116. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  117. The Livewire BBS    <=-  (Change this to your BBS name)
  118. Richard             <=-  (The Sysop's first name)
  119. Paquette            <=-  (The Sysop's last name)
  120.  
  121. Example configuration file for CHAIN.TXT
  122. ----------------------------------------
  123.                                                                              
  124. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  125. The Livewire BBS    <=-  (Change this to your BBS name)
  126. Richard             <=-  (The Sysop's first name)
  127. Paquette            <=-  (The Sysop's last name)
  128.  
  129. Example configuration file for GTUSER.BBS
  130. ----------------------------------------
  131.                                                                              
  132. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  133. The Livewire BBS    <=-  (Change this to your BBS name)
  134. Richard             <=-  (The Sysop's first name)
  135. Paquette            <=-  (The Sysop's last name)
  136. 1                   <=-  (COM port number - defaults to 1)
  137. 1                   <=-  (Node number - defaults to 1)
  138.  
  139. Example configuration file for TRIBBS.SYS
  140. ----------------------------------------
  141.                                                                              
  142. C:\BBS\TRIBBS.SYS   <=-  (Full pathname of your TRIBBS.SYS file)
  143. The Livewire BBS    <=-  (Change this to your BBS name)
  144. Richard             <=-  (The Sysop's first name)
  145. Paquette            <=-  (The Sysop's last name)
  146.  
  147. Example Batch File 
  148. -------------------
  149. A sample batch file is included and is similar to the following:
  150.    ECHO OFF
  151.    CD\DOORS                <=- Switch to the door's Directory.
  152.    DOOR DOOR.CNF           <=- Execute the door program and pass the
  153.                                 configuration filename to the program.
  154.    CD\PCB                  <=- Go back to PCB DIR when user exits door.
  155.    BOARD                   <=- Restart BBS.
  156.                                                                              
  157. This Door is multi-node  compatible so you may run more than 1 node from
  158. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  159. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  160. variables, (q.v.)
  161.  
  162.                          Environment Variables
  163.  
  164. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  165. variables. Non-PCBoard systems may also use these variables by including
  166. the following in either your BBS batch or AUTOEXEC.BAT
  167.  
  168.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  169.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  170.  
  171. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  172. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  173. .CNF file for multi-node operation!
  174.                                                                              
  175. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  176. command line.  For example:
  177.                                                                              
  178.      DOOR DOOR.CNF /5
  179.      or using the PCBDRIVE procedure: SET IRQ=5 and use
  180.      DOOR DOOR.CNF /%IRQ%  
  181.                                                                              
  182. This tells the program to use IRQ 5 instead of the standard IRQ.
  183.  
  184.                            Top Ten Bulletin
  185.                            ----------------
  186.                                                                              
  187. The first time you run this door online it will create 3 files called
  188. ****.BUL, ****.BLT and ****.BLT. If you  wish to change the path
  189. or filename of the  Bulletin,  you must edit  ****.BUL and  change the
  190. first line to whatever path/filename you desire, assuming that this door
  191. requires or has a bulletin to display.. these docs are generic for all
  192. The Livewire Doors and some of them DO NOT create a bulletin.
  193.  
  194.                               Sysop Keys
  195.                               ----------
  196.  
  197. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  198.          written to DOOR.SYS and USERS.SYS
  199. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  200.          and/or written to DOOR.SYS and USERS.SYS
  201. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  202. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  203.          and/or written to DOOR.SYS and USERS.SYS
  204. F8    -  Returns the caller involuntarily to the BBS.
  205. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  206.          and/or written to DOOR.SYS and USERS.SYS
  207. F10   -  Activates SysOp CHAT mode within the DOOR.
  208. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  209. UP    -  Give the caller extra time while in the DOOR.  
  210. DN    -  Subtract time from the caller while in the DOOR. 
  211. HOME  -  HELP key for Status Line options.
  212. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  213. ALT-X -  PCBoard will exit after current caller logs off. Value is
  214.          passed to PCBoard. Not available on non-PCBoard systems.
  215.  
  216.                              Distribution
  217.                              ------------
  218.                                                                              
  219. This program is being distributed via the SHAREWARE concept and as such,
  220. may be copied freely with the following restrictions:
  221.                                                                              
  222.         * The program must be supplied in it's original unmodified
  223.           form, including documentation.
  224.                                                                              
  225.         * This program may not be distributed as part of any commercial
  226.           application or service without the express, written consent
  227.           of the author.
  228.                                                                              
  229.         * Vendors of Shareware/Public Domain software may not
  230.           distribute this program without the express, written
  231.           consent of the author even if Vendor has been approved
  232.           by the Association of Shareware Professionals (ASP).
  233.  
  234.                              Registration
  235.                              ------------
  236.                                                                              
  237. This door represents  many hours of  programming and the author deserves
  238. just compensation for his time, efforts and expertise.  If you find this
  239. program to be of some  value and you  continue to use it on your system,
  240. you must return the order form provided along with the registration fee.
  241. Registration  entitles you to  free upgrades via  modem from  The Livewire
  242. BBS Support Conference.  Payments should be  made in the  form of a check or
  243. money order. Foreign orders must be in U.S. funds drawn on a U.S. bank.
  244.  
  245. Online registration with Visa or Mastercard is available via our Credit
  246. Card Door at the following system:
  247.                                                                              
  248.                   The Livewire BBS: (609) 235-5297 HST
  249.                                                                              
  250. NOTE: If you register by mail,  your registration number will be posted
  251.       in a private message on The Livewire BBS. 
  252.  
  253.                                Copyright
  254.                                ---------
  255.                                                                              
  256. This door is Copyrighted(c) 1989-93 by Richard Paquette, and is distributed
  257. as Shareware. Under this concept you may use the SHAREWARE (unregistered)
  258. version for a  reasonable period of  time for evaluation  after which you
  259. must either register your copy or discontinue  usage.
  260.  
  261.                                Warranty
  262.                                --------
  263.                                                                              
  264. This product is provided as is without warranty of any kind.  The entire
  265. risk as to the results and performance of the program is assumed by you.
  266. Futhermore, the  author does not warrant, guarantee, or  make any  other
  267. representations regarding the use of,  or the  results of the use of the
  268. program,  and you rely on the  program and  results  solely at  your own
  269. risk.  The author  cannot and will not accept  responsibility for system
  270. damage, loss of profit or any other special, consequential or incidental 
  271. damages  resulting  from  the use of or inability to  use this  product.
  272.  
  273.                                Com-Ports
  274.                                ---------
  275.  
  276.                    DoorFrame now supports COM 0 thru 15.
  277.  
  278.                              Fossil Drivers
  279.                              --------------
  280.                                                                              
  281. This door may be used with Fossil drivers such as X00 & BNU.  This makes
  282. it compatible  with most  multi-port  boards.  To use the Fossil  driver
  283. instead of the standard COM ports, include  /FD on the command line when
  284. running the door. For example: DOOR DOOR.CNF /FD
  285.